Granda's Blog

GitHub Page+Hexo搭建博客详细教程

发表于 | 分类于

安装Node.js

  • 到Node.js官网下载系统对应版本的Node.js，并安装

安装git bash

  • 到git官网下载系统对应版本的git bash，并安装

申请github账户并创建博客仓库

  • 仓库名称应该为：你的用户名.github.io

配置ssh

  • 打开git bash

  • 设置uesr.name和user.email

    1
    2
    git config -global user.name "your GitHub's username"
    git config -global user.email "your GitHub's email"

  • 生成ssh密钥

    ssh-keygen -t rsa -C "your GitHub's email"
  • 一直点击回车键，用户文件夹中会创建一个.ssh文件夹，该文件夹中含有ssh密钥文件
  • 在个人的github点击用户头像→Settings→SSH and GPG keys→New SSH key→将.ssh文件夹中的id_rsa.pub中的内容复制到Key文本框中，然后点击Add SSH key

安装Hexo

  • 默认服务器执行npm命令较慢，可以改用淘宝的镜像网站
    npm config set registery "https://registery.npm.taobao.org"
  • 在git bash中执行下面命令安装hexo
    npm install -g hexo
  • 进入Blog文件夹（手动在E盘根目录创建blog文件夹）
    cd e:blog
  • 初始化Hexo
    hexo init
  • 安装其它插件
    npm install
  • 编写Blog
    在blog\source_posts文件夹中编写markdown格式的Blog文章
    hexo new "new_blog_name"
    执行上面命令会在blog\source_posts文件夹中创建标题为new_blog_name的markdown文件
  • 生成静态页面
    hexo generate
    静态页面存储在blog\public文件夹
  • 开启本地服务器
    hexo server
    打开浏览器访问http://loaclhost:4000/ ，可以进入blog页面

将hexo部署到github上

  • 打开blog_config.yml文件，编写以下内容

    1
    2
    3
    4
    deploy:
      type: git 
      repo: git@github.com:username/username.github.io.git
      branch: master

  • username为你的github用户名

  • 清除已经生成的静态页面（可选）
    hexo clean
  • 重新生成静态页面
    hexo generate
  • 部署
    hexo deploy
    打开浏览器访问http://username.github.io ，可以进入blog页面